<$INCLUDE FILE="inc/macro.hsc"> <* macro to format an explanation *> <$MACRO explan NAME:string>
<$INSERT TEXT=>
<* macro to format an example *> <$MACRO example EXMP:string>
<$INSERT TEXT=>
All options and swiches are case-insensitive. If you start without any options, a short help message will be displayed.

understands the following options:

Display a short help message. Specifies the input filename. To use stdin as input file, see PipeIn. Specifies the output filename. If no output file is given, stdout is used instead. Specifies the destination directory for output file. Redirects error output to a file. By default, stderr ist used. Ignore warning message number. Numeric, can occure multiple. (eg IGN=21 IGN=18.)

Switches

Enable Absolute URIs Check existence of local URIs <* Read input file from stdin*> Replace special charaters with its entity (eg "ü" becomes "&uuml"). Replace special charaters "&", "<", ">", "\"" (quote) with its entity (&amp;, &lt;, &gt; &quot;) if they are surrounded by white-spaces. Display file and line number during conversion. Included files are also displayed. After processing a file, the filename and the total number of lines remain visible. (output goes to stderr.) More verbose status output. Enables the Status-switch.

Examples

Simly performs a syntax check on hugo.html and writes a dummy-output to the temporary directory. Same as above, but also displays a status message during conversion. Additionally, all special characters like "Ü" or "ß" are replaced by its entities ("&Uuml;" and "&szlig;") Process subfile people/hugo.hsc. The current directory is the main directory of the project. The HTML-object is created in /pub_html/people/hugo.hsc. All local URIs referenced within hugo.hsc are interpreted as absolut URIs and are converted to relative path when written to the HTML-object. Same as above. Additionally, all URIs referenced are checked for existence. If eg, people/hugo.hsc references to prog/project/thing.hsc, the file /pub_html/project/thing.html must exist or an error will occure.
Note: Also mind that the HSC-source ends with ".hsc", but the HTML-object automatically gets the extension ".html". Therefor, all references must end with ".html".